2600/7800 DEVELOPKENT KIT 


CARE AND FEEDING INSTRUCTIONS 


A full, complete 2600/7800 development system includes the following: 
HARDWARE: 

520ST or 1040ST COMPUTER (or Mega ST)) 

SH204 HARD DISK 

SF354 or SF314 FLOPPY DISK (or equivalent) 

SM124 or SC1224 MONITOR (or equivalent) 

7800 GAME MACHINE 
TRANSFER CABLE 
DEVELOPMENT RAH CARTRIDGE 
TELEVISION (not furnished by Atari) 

EPROM CARTRIDGE (for appropriate game system) 

SOFn^ARE: 


DEVELOPMENT KIT DISK: 

40C0L.S (Sample source code for ItO-column text display) 

ASH. EAT (Submit file for the batch utility) 

BATCH. TTP ( Batch utility: executes programs in submit file) 
CONV65.PRG (Converts .0 file to S-reeord format ".SR") 
DLOAD.TTP (Downloads code to the 7&O0 and acts as terminal) 
K.7TP ("Kermit" - for inter-computer communication) 

MAC.PRG (cross-assembler) 

M.AH1A.S (Recommended 7600 equates file) 

STELLA. S (Recommended 2600 equates file) 

HE. TIP (Micro-Emacs editor) 

WAIT.PRG (Allows messages to remain on screen until <CR> ) 
HARD DISK BOOT DISK (comes with hard disk drive) 

DS5027 NEOCHROME (ST graphics program) 

SAMPLE SOURCE CODE (for the appropriate game system) 


D<X:UMENTAT10N FOR 2600 AND 7800 DEVELOPMENT: 

ASSEMBLER MANUAL 
EDITOR MANUAL 

STELLA (2600) PROGRAMMER'S GUIDE 

2600 GAME STANDARDS AND PROCEDURES 

7800 SUPER CART SPEC 

7800 PROGRAMMING GUIDE 

SARA PROGRA.AMING INSTRUCTIONS 

MOTOROLA S RECORDS FORMAT 

7800 GAME STANDARDS AND PROCEDURES 

NOTE FREQUENCIES FOR ATARI 2600/7800 SOUND SYSTEM 


7800 SCHEMATIC 
2600 SCHEMATIC 

DESCRIPTION OF 7800 "PRO" DEVELOPMENT SYSTEM UPGRADE {debugfer connands) 
-AND ANY OTHER DOCUHDfTS WHICH MAY BE GENERATED FROM TIME TO TIME. 


SETTING UP THE DEVELOPMENT SYSTEM; 


Set up the ST computer per Its instructions. 


Connect standard 7000 to power supply, attach 7800 to TV set. 

Attach standard parallel transfer cable to printer port of ST and to the 
25-pin D connector on the development system cartridge. 

Put the development system cartridge in the cartridge port 
(chips to the rear) and power-up the 7800. 

Run DLOAD.TTP on the ST and if properly connected, you will see the 
sign-on message from the development system cartridge on your ST 
screen (another message is displayed on the TV screen). 


And off you go! 


SOME INFORMATION THAT WAS NEVER GIVEN IN ANT OF THE OTHER 
DOCUMENTATION ; 


How to use the right and left Joystick buttons (7800 games only) ; 
Initialize SWCHB with the following ll instructions: 

LDA 

STA CTLSWB 
LDA #0 
STA SWCHB 

Read the fire buttons from; 

INPTO - player 0, right button (d7=l if pushed) 

INPTl - player 0, left button (d7=l if pushed) 

INPT2 - player 1, right button (d7=l if pushed) 


Hou 


INPTi - player 1. left button (d7'l if pushed) 

;o proeram for the 2600 on the 7800 Developoent System; 

1 A 2600 "lock-in” must be performed before anything else 
and is accomplished by these 2 instructions; 

LDA #*FD 
STA *08 

2. Six 4k blocks of memory space ("banks" on the cartridge) 
available for use by 2600 game developers. They are: 
5000-5FFF 
7000-7FTF 
9000-9FFF 
BOOO-BFFF 
DOOO-DFFF 
POOO-FFFF 


Since 2600 cartridges have 1,2.4. or 8 banks of 4k each, only 
cartridges of up to 4 banks in size may be developed with this system, 
8 bank cartridges will need the dedicated 2600 deve lopment system when 
it comes out It is recommended that the FOOO-FFFF bank not be used 
during game development (except to store hardware vectors ana to 
execute^the 2600 lock-in described above) since 122 bytes at FF80-FFF9 
are dedicated to 7800 encription signatures i the development system 
reauires this area for system code. FtX)0-FF7F may be used, but it 
cannot be "packed" full of code as would be possible in the EPROH 
cartridge. Also, keep in mind that the development system does not 
emulate bank switching or SARA ram accesses precisely. S^ce the 7800 
D was not expressly designed to run in 2600 mode, 

» been observed when it is used in 2600 mode. Most 
boards are tested to see how they perform in 2600 
t fine but others only allow load & go with no debugger 
mce 2600 mode has been locked-in. If the debugger 
the 2600 program has been started (either no 
? responses to legitimate debugger commands). 


development system w 
some problems h 
development system k 
mode . Some wc 
communications 

communic 






; (01 


Try a different base-ur 


Summary of differences between dev 


Development system as 2600; 

1 Code in bank FOOO-FFFF 

must not reside st FF80-FFF9 

2. Bank switching timing can 
be simulated but other bank 
switching side-effects cannot 


system as 2600 i 2600 EPROM cartridge; 


EPROM cartridge: 

Bank F(X)0-FFFF may be used in its 
entirety. 

Bank switching must be used for 
access to other 4k blocks. Bank 0 
code cannot access bank 1 data. 
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be directly observed. For 
example, code executing from 
bank 0 can access data from 


3. SARA ran accesses can be 
simulated provided that 
read & write accesses 
are in the same 128 byte 
block. 

ll. The two instruction 2600 
lock-in code described above 
must preceed all other code. 


When attempted, this is usually 
quite evident as a bug, 


SARA ram must be read at FO8O-FOFT 
and written to at FOO0-FO7F. 


The two instruction 2600 lock-in 
code is not necessary and uses 
4 bytes of ROM that could be used 
otherwise. 


Bank switching is used for 2600 cartridges larger than 4K. When it 
was first designed (in the stone age of 1977). the 2600 base-unit 
brought only enough address lines out to the cartridge to address 
4k. How that ROM has become so cheep. 2600 Bank switching necessary 
to address larger carts. This is accomplished by reading a "magic” 
location. Normally, a LDA ABSOLUTE is executed followed by a JMF 
ABSOLUTE. A copy of these two instructions is found at the same 
offset in both the bank being switched to and the bank being switched 
from. In addition, at power-up. the programmer cannot assume which 
bank will get control first. All banks must vector RESET thru proper 
bank switching code to the bank with the start-up code. The magic 
addresses to be read for bank switching purposes (when applicable) 


4 bsxd< 8 bank 


JFFF8 

SFFF^ 


JFFF6 $FFF2 

$FFF7 JFFF3 

$FFF8 $FFf'4 

JFFF9 $FFFS 

SFFF6 
IFFF7 
JFFF6 
tFFF9 


lowest bank * 

1 

V 

highest bank # 


For more details, see sample source code. 


Available PAL Colors: (2600): 

0,2,4.5,6,7.A.B,C,D Lums are the same 


Conversions 


blBCk 


1- 2 6'C B-7 

2- 4 7-C C-5 

3- 6 8-B D'5 

4- 6 9-D E-5 

5- A A-D 

Odd or even numbered seen lines may alter the colors to 
and white. (2600 PAL conversion) 


Some previously released 7600 cartridges used additional RAH provided c 
the cartridge itself. This has become prohibitively expensive md is 
not allowed for future game development. Exceptior 
If cleared in writing by Atari management first. 


s will be made only 


When sending EPROMS 
provided (on a 


ri, the following information should be 
3/4” label that does not cover up the 


GAME NAME (including system - may be abbreviated] 

DATE 

CHECKSUM. 

BANK # 


For example; 7800 BALLBL. 2600 SOCC 

9/28/87 9/28/87 

E2D8 300B HI 

BANK67 


The preferred form of game milestone submission to Atari is sending 
the source code on floppy disk together with the .0 files generated by 
that source. A .BAT file containing the command line for DLOAD.TTP 
would be a convenience as well. Source 
submissions before game release. 


5 code is manditory for final 


If there are any questions regarding 
hardware, call John Feagans at 
and engineer Jose ”Beam-Me-Up" 
through CompuServe for 24-hour 
booklet for details) . 


the use of the software or 
Atari: (408) 745-‘t923. He 
Valdes are also available 
QtA service (see CompuServe 


Dave Staugas may 


also be reached 


questior 


(408) 745-2267. 


Description of the At^ri 7800 ’Pro' Develo caent Sygto Upgrade 

Docunerit revision date: 13*July“® 


New features (vs. previous develop«nt systen): 

• Downloads proceed up to 6 tioes faster than l 
system - 


s previous development 


ProeraiDS to download need not be converted to .SR (S-records) 
via the CONV65 PRO. Object files straight from the assembler (MAC. PRO . 
files) may be used directly, saving the CONV65.PRG step and increasing 
download speeds by a factor of 2. .0 files must be used if symbolic 

references are desired with the debugger. 


• An on-board symbolic debugger is included with trace, go with break- 
point, list (disassembly), set (change memory), register change, and dump 
memory commands currently available. 


Communications between ST and 7800 base unit are accomplished via a new 
bi-directional parallel 1/0 port on the development cartridge making the 
joystick ports free on the base unit for, of all things, joysticksi 


Any production 7800 base unit may 
"cartridge” (no need to modify the 
system cartridge ROM is encrypted 


se used with the development system 
base-unit ROM) since the development 
to "pass" the encryption test of the base 


Programs (whether single or multiple bank) may be loaded without use of 
a Load/Run switch since the develpment system cartridge manages memory 
automatically during download. 

New board has been designed especially for development system use wd 
will (hopefully) prove more reliable than the previous kludge-board. 


Checksum is computed for S-records after reeding data back from RAM 
rather than simply adding up the data as received and then storing to RAH 
as was done with the previous system. A similiar method is used with .0 
files except a l6-bit checksum is used to improve reliability detection. 


Items you should have with this new Development System Upgrade; 

1. Single board (large) cartridge with parallel port. 

2. Parallel ribbon cable. 

3. Diskette with DLOAD.TTP program. 


Using the Development System Upgrade ; 


To use the Atari 7800 "Pro" development system, simply plug the 
supplied 7800 development card into any 7800 base unit and c^e^the 
parallel cable between your ST computer's printer port wd 
development card. Power-up the base unit and wait about 2 seconds ( AT^I 
4 Fuji*^ls displayed on TV screen while decryTtion is performed). The blue 
screen with the 7800 sign-on message should now be displayed. If your base 
unit has the old transfer program BOM, you will need to depress the 76L(U 
reset button to start the new debug cartridge ROM. 

Now, run DLOAD.TTP on the ST. If an .SR file or .0 file is 
downloaded, type it's name on the command line when invoking DLOAD.TTP. If 
the file we is omitted, the program will first look for an .0 file on the 
current directory. If an -0 is not found, an attempt will be made to load 
an .SB file. Multiple files of either type may be listed o' 
line separated by spaces or commas, and they will t~ 
they appear there. Only .0 files contain symbols t 

symbolic debugger so this file type is preferrable when debugging i 
performed . The type of download to be performed i 

type (.0 or .SF) so ' ' '''' 

its proper .0 or -SR. 

For game programs that do not require multiple banks, bank ler 
be used automatically and no relocating of S-records is necessary. 

Multiple bank programs will still require a separate assembly for each bank 
as with the old development system but no relocating is necessary. If you 
are loading .0 files (w/symbols>. the following two lines 
be included in each source file (bank #3 example is shown): 


BANKNBP. 

DUMm’ 


3 :this equate tells DLOAD.'OP to load in bank #3 

BANKNBR 


Due to a quirk of HADMAC (the Atari cross-assembler), the symbol 
BANKNBR will not be included in the .0 file symbol table unless it is used 
as well as being defined. So, use it in another dummy equate to force it s 
inclusion into the symbol table. Another quirk of MADMAC that I have 
observed; symbols stating with upper-case "L" are not included in the 0 
file! Still another bug observed in MADMAC: If an entire page of 65 
memory is initialised to OO's. the assembler omits the page in the '0 

-irely The symbol BANKNBR (must be ell upper-case) should not be used ir 
; other way If this symbol is not found, bank HO will be assumed. If 
1 prefer to use S-records, the way to switch ba^s is via a new reco’- 
tvoe that is used expressly for bank switching. A summary of the three 
record types understood by the development system is as follows (bl^ 
spaces are added for clarity and should not be present in actual a 


you prefer 


5 three S- 


Example 


S-record description 


S 1 23 8000 78 56 09 ... 7A 


S Starting byte of every S-record 
1 Record type 1 for download data 

23 Byte count in hex (add 3 to 
include addr 4 checksum) 

6000 Starting load address, this record 

78 

56 

09 etc. is 32 bytes of dload data 

7A is the checksum byte when added 
to the data bytes, 2 address 
bytes and the byte count byte 
should equal $FF (ignoring 
overflo) . 


S Starting byte of every S-record 
3 Record type 3 for switching banks 
05 A switch to bank #5 is performed, 
(no checksum needed) 


S Starting byte of every S-record 
9 Record type 9 for terminating 
this download. 

(This record is automstically 
appended after each download) 


Once the file(s) h 
that allows the program 
program. The prompt is 
receive commands from t 
modeled after those of 


ive downloaded, DLOAD. TTP becomes e terminal of sorts 
oer to inspect 76OO system R.AH/R0M and debug his 
a tilde ("'") indicating the debugger is ready to 
the ST keyboard. The commands for this debugger are 
SID PRG which comes with the ST development system. 


Some of the commands accept addresses or data as arguments. Any 
address or data may be expressed in the following 3 ways; 


As a hex constant (exBmples--FCE2 40A AE) . 


As a hex constant preceeded by a bank number 4 colon. 
The bank number (0-7) is only meaningful when applied 
addresses in the SOOO-BFTF range where bank switching 
occur. (examples--0:9A04 5=8000 2;BADD) 


As a symbol. A symbol must be preceeded by a per 
" start") and must be found in the programmers 
from the .0 file(s) that were downloaded, 
(examples-- .start .main .loop) 


Commands are "sent” whe 
backspace before that time, 
may suspend, 'resume the type- 
Striking any other key will 


n the <cr> is entered and may be editted with 
If a command calls for long type-out, the user 
out with cntrl-S/cntrl-Q (xon/xoff) sequences, 
cancel a long type-out. 


Coim&ands currently available : 


•g[x*xx][ ,yyyy} 

Co (execute) starting from current PC or at optional xxxx address until 
optional yyyy breakpoint is reached. 


-x[PC lA|X|YlS|BlPi] 

examine and change registers command. If the optional register name is 
omitted, the contents of all registers are displayed. If a register name 
is given, that register alone is displayed and the user may input a change 
to the contents of that register. "PC" is a 16 bit value, while 
"A" ,"X’',"V" ,"S". and "P" are 8-bit values. "B" is the current bank number 
and should be in the range 0-7 - 


-d[xxxx][ ,yyyy] 

Dump memory starting from last dumped address or optional xxxx address 
until optional yyyy address. 


•l[xxxx][ ,yyyy] 

List (disassemble) memory starting from last listed address or optional 
xxxx address until optional yyyy address. 


Trace (execute) one ins 
count xxxx is entered, 
to trace is a JSB, ‘tw 
and break upon return. 


;tructlon starting from current PC or if optional 
trace xxxx program instructions. If the instruction 
will execute the entire routine called by the JSR 


Set (change) memory command. The address xxxx to set must be provided. 


The current contents of the oemory 
user oaj enter a new value or skip 
exit this node, type a period then 

Example: 

'sDOOO 
DOOO E2 42 

DOO: 78 <cr> 

D002 60 20 
DOO3 CA .<cr> 


address indicated is displayed and the 
to the next address with a <cr>. To 
<cr> . 

remarks: 

change memory starting at DOOO 
contents E2 changed to 42 
contents 78 left alone 
contents 60 changed to 20 
exit X command 


Shut-up sound command. When breakii 
latches may be left in an annoying s 
with the 2 commaiid . Zeros are writ1 


into an executing program, the sound 
jte. The sounds of silence may be had 
1 to all six sound registers. 


Enable or disable Display List NHI processing while in "system" mode. A 
minus sign followed by "n" will force any DLl’s that occur while the 
debugger is processing user commands to merely RTI with no further 
processing, "n” without the minus enables DLl's in system mode^but^with 71 
cycles of overhead added. When executing f 
command, the state of this flag t 
with no added overhead. 


i effect--DLI's will execute normally 


Additional notes on debugger use: 


! 7&00 developmer 
An IRQ is 
simply re- 


If it IS desired to break into an executing program on 1 
system, the user need merely type cntrl-C at the ST keyboard, 
generated and the program’s state can be examined. To resums 
start with the "G” command. The IRQ will not work however it tne user s 
program executes an SEI instruction (set interrupt disable) . Chmge all 
SEI% to CLI's while debugging, then when it’s time to burn EPROM s, ch^ge 
them back to SE’ Since the 7800 target system normally has no external 
IRQ connected, it probably won't hurt to run your program with IRQ enabled 
anyway. When a running game has been broken into in this w^, the main 
program has stopped, but DLl’s will continue to be processed. However. 71 
cycles of overhead is added to the DLI routine which may be unacceptable 
for some applications. If this is the case, use the -n co^^d to stop 
ksplsy list processing (DLI vector will just point to ^ RTI). To return 
to the ST’s desktop (or command line) while a down loa ded game 1 
use the <esc> key. This is the way to exit DLOAD.TTP at any tl 




When invoicing DLOAD.TTP. the coamiand line nay include (in addition to 
the above described list of files to download) the 1st debugger command to 
be issued after downloading has finished. In this way. it is possible to 
"load L go" by automsticaly issuing the "g" command. This initial comand 
should be preceeded by a minus and should be the last item on the 
command line. An example of the DLOAD.TTP command line using this feature: 

DLOAD.TTP fileO file! fileP -g 

Occassionally. communications seems to hang up between ST and 7800 
development system. This can often be broken thru by use of cntrl-C. As 
with any alpha release software, bugs and other annoyances will be present 
in this the first release of the Atari 7800 Pro Development System 
Upgrade! which you will probably discover for yourself. I would like to 
hear about anv problems you may be having or requests for features not 
found here. You may contact me. Dave Staugas. at [d06j 7*15-2267. 


tiou let’s get going and create 7600 gomes that eat Nintendo alive! 
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7600 SUPER CART. 


A One Megabit RDM in the 7600 super cart will be organized ae 
one #i«ed lt>K x 6 space (SCOOO to »FFFF) and seven ItK k 6 bant-ed 
slots (S8000 to SBFFF). Changing banks is achieved by writing to 
any location Froir. SBOOO to BFFF with the appropriate bank number. 

The Bank data should be organized as -followss 
Bank Data (binary) 

0 OOP 

1 001 

2 010 

3 Oil 

4 100 

5 iOl 

b 110 

7 111 (same as +ixed bank at SCOOO-SFFFF) 


The 7800 Super Cart. is designed -for various sizes o-f ROMs 
and will support an BK « G SRAM. Below is a jumper chart showing 
all supported con-f i gur at i ons of the cartridge: 


512k ROM/EPROM 


U4 Options I Ml 


Ibk/bAk 5RAMI- 


1024k RDM/EPROM lEmbtv 


256k ROM/EPROM 


banked il6k/64k SRAM!" 


i?Bk ROM csOI- 


w4 I w5 I w6iw7l wB 


TBD 


7800 Cart. Memory K^ap 



MOTOROLA 


RECORDS 


• MOTOROLA EXORCISER FORMAT, CODE B 


in tne tKO'ff. The AM'ise ot the Em Ute hyic in the 
recc'd 15 iKC'aeaed Cv the test 4 cherectere c* the preEr 
Oeta pyree fctiow, eeeh represented by 2 heieedecimei 
cherectere The npmbe' of dete bytee occurring mur be 3 
4es5 then the byte count. The euffix ie e EcTierecte' 



NOTE FREQUENCIES FOR ATARI 2W(V7800 SOl'NDST STEM 




